home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / mus / misc / DelfScope.readme < prev    next >
Encoding:
Text File  |  2000-11-02  |  4.9 KB  |  125 lines
  1. Short:  Oscilloscope/analyzer for Delfina DSP
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/misc
  4.  
  5.  $VER: DelfScope 0.1 (Tue 03-Oct-2000)
  6.  
  7.  
  8.  #features
  9.    -reads audio data from Delfina input connector (external source)
  10.     or from a sound player program (AHI, DelfSF etc.)
  11.  
  12.    -realtime displays:
  13.      - stereo level meter
  14.      - stereo oscilloscope
  15.      - spectrum analyzer
  16.  
  17.    -can use any native Amiga screen mode (no CGFX support, sorry)
  18.  
  19.    -free software (full source code included, of course)
  20.  
  21.  
  22.  #requirements
  23.    -CPU 68020+
  24.    -AmigaOS V37+
  25.    -Delfina DSP board
  26.  
  27.    -developed on: A1200 (68030+882 @ 40MHz, 16MB Fast, Delfina1200 DSP)
  28.  
  29.  
  30.  #how to use it
  31.    Connect an external audio source (CD player, TV etc.) to your Delfina's
  32.    input or launch your favourite sound player program. Start DelfScope.
  33.    These options can be used:
  34.  
  35.    MODEID   / -m    screen mode ID.
  36.                     if omitted a reqtools screenmode requester appears.
  37.                     specify a decimal or hexadecimal (prefix $ or 0x) value.
  38.                     (example: MULTISCAN:Productivity - 233508 or 0x39024)
  39.                     the visible screen size should be at least 640x480 pixels.
  40.                     NOTE: only native Amiga modes (ECS/AGA) are supported!
  41.  
  42.    INPUT    / -i    name of the DelfModule to use as source.
  43.                     (default: "Connectors" - Delfina's input connector)
  44.                     here you can specify the name of the DelfModule that
  45.                     supplies DelfScope with input data. use the "listmod"
  46.                     command while you run a particular Delfina program to
  47.                     find out the name of its DelfModule. some examples are:
  48.                     "14Bit-NotePlayer" (AHI for DeliTracker by Chris Hodges),
  49.                     "DelFX", "DelfSF", "DelfAIFF", "DelfMPEG".
  50.                     NOTE: the names are case-sensitive!
  51.                     and unless you're a lucky owner of a Delfina Plus with
  52.                     128K memory / 74MHz DSP you will not be able to run
  53.                     DelfMPEG and DelfScope at the same time.
  54.  
  55.    Use these keys on the DelfScope screen:
  56.  
  57.    Esc      quit
  58.    Space    pause / continue
  59.    o        oscilloscope mode
  60.    s        spectrum analyzer mode
  61.    1...9    set redraw rate (lower=faster)
  62.    + -      increase / decrease input gain (for "Connectors" input only)
  63.  
  64.  
  65.  #technical stuff
  66.    -The width of the oscilloscope display depends on the vertical refresh
  67.     rate (fps). On slower screen modes (e.g. PAL - 50 Hz) the display is
  68.     wider so that all input data can be visualized.
  69.  
  70.    -The spectrum analyzer employs a 1024-point FFT routine that runs on the
  71.     DSP (adapted from Motorola example sources).
  72.  
  73.    -The plot routines (written in assembly language) are pretty simple and
  74.     use brute force in order to be fast. They only work with native screen
  75.     modes because they write directly into chip memory.
  76.     Anybody interested in better/more flexible plot routines? Then just
  77.     take my sources and modify them as you want.
  78.  
  79.  
  80.  #known problems
  81.    -DelfScope sometimes simply freezes my Amiga system, so don't work on
  82.     any precious data in the background - you have been warned!
  83.     This might be a "Delfina bug" of some kind, but currently I have no idea
  84.     how to solve this problem. :-(
  85.  
  86.  
  87.  #author
  88.    mailto: smack@smack.de
  89.  
  90.    DelfScope - oscilloscope/analyzer for Delfina DSP
  91.    Copyright (C) 2000  Michael Henke
  92.  
  93.    This program is free software; you can redistribute it and/or modify
  94.    it under the terms of the GNU General Public License as published by
  95.    the Free Software Foundation; either version 2 of the License, or
  96.    (at your option) any later version.
  97.  
  98.    This program is distributed in the hope that it will be useful,
  99.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  100.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  101.    GNU General Public License for more details.
  102.  
  103.    You should have received a copy of the GNU General Public License
  104.    along with this program; if not, write to the Free Software
  105.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  106.  
  107.  
  108. ============================= Archive contents =============================
  109.  
  110. Original  Packed Ratio    Date     Time    Name
  111. -------- ------- ----- --------- --------  -------------
  112.    18113    7000 61.3% 03-Oct-00 03:53:00 +COPYING
  113.    34132   20632 39.5% 03-Oct-00 03:53:00 +DelfScope
  114.     4145    1993 51.9% 03-Oct-00 03:53:00 +DelfScope.readme
  115.      139     115 17.2% 03-Oct-00 03:53:00 +CHANGES
  116.    21476    6565 69.4% 03-Oct-00 03:53:00 +DelfScope.c
  117.     8970    2238 75.0% 03-Oct-00 03:53:00 +scope_asm.a
  118.     1386     596 56.9% 03-Oct-00 03:53:00 +scope_asm.h
  119.    34132   11158 67.3% 03-Oct-00 03:53:00 +scope_dsp.a56
  120.     1393     658 52.7% 03-Oct-00 03:53:00 +scope_dsp.h
  121.      198     131 33.8% 03-Oct-00 03:53:00 +SCOPTIONS
  122.      290     121 58.2% 03-Oct-00 03:53:00 +smakefile
  123. -------- ------- ----- --------- --------
  124.   124374   51207 58.8% 04-Oct-100 05:00:16   11 files
  125.